Skip to content

docs(session-replay): Clarify iOS performance impact on older devices#16205

Merged
philprime merged 2 commits intomasterfrom
philprime/session-replay-performance
Feb 3, 2026
Merged

docs(session-replay): Clarify iOS performance impact on older devices#16205
philprime merged 2 commits intomasterfrom
philprime/session-replay-performance

Conversation

@philprime
Copy link
Member

DESCRIBE YOUR PR

Overhaul the Session Replay performance overhead documentation to better communicate the potential for scrolling stutter and frame drops on older iOS devices. This addresses feedback that the documentation didn't clearly explain the impact on scroll behavior.

Changes:

  • Add dedicated "Performance on Older Devices" section with clear warning
  • Explain why stutter occurs (main thread blocking during screenshot capture)
  • Document scenarios that increase likelihood of stutter (heavy animations, complex view hierarchies)
  • Add "Understanding Main Thread Impact" section with timing details
  • Include View Renderer V2 performance comparison table
  • Add cross-references from React Native and mobile docs to iOS-specific guidance

Closes getsentry/sentry-cocoa#7225

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

  • Urgent deadline (GA date, etc.):
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

Overhaul the Session Replay performance overhead documentation to better
communicate the potential for scrolling stutter and frame drops on older
iOS devices. This addresses feedback that the documentation didn't clearly
explain the impact on scroll behavior.

Changes:
- Add dedicated "Performance on Older Devices" section with clear warning
- Explain why stutter occurs (main thread blocking during screenshot capture)
- Document scenarios that increase likelihood of stutter (heavy animations,
  complex view hierarchies)
- Add "Understanding Main Thread Impact" section with timing details
- Include View Renderer V2 performance comparison table
- Add cross-references from React Native and mobile docs to iOS-specific guidance

Closes getsentry/sentry-cocoa#7225
@philprime philprime self-assigned this Jan 29, 2026
@vercel
Copy link

vercel bot commented Jan 29, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment Feb 3, 2026 10:00am
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview Feb 3, 2026 10:00am

Request Review

@codeowner-assignment codeowner-assignment bot requested review from a team and jas-kas January 29, 2026 11:01
Copy link
Contributor

@antonis antonis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Thank you for also updating the RN section 🙇

Copy link
Contributor

@coolguyzone coolguyzone left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Thanks for adding

@codeowner-assignment codeowner-assignment bot requested review from a team February 3, 2026 09:49
@philprime philprime enabled auto-merge (squash) February 3, 2026 09:56
@philprime philprime merged commit e14c4d8 into master Feb 3, 2026
14 checks passed
@philprime philprime deleted the philprime/session-replay-performance branch February 3, 2026 10:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Rework session replay performance impact in documentation

3 participants